package org.dromara.common.excel.core;

import com.alibaba.excel.read.listener.ReadListener;


/**
 * @Author 刘武贵
 * @Date 2024/8/15 22:00
 * @Description 功能描述：Excel 导入监听
 */
/**
 * Excel监听器接口，继承自ReadListener泛型接口，用于处理Excel读取过程中的事件监听
 * 该接口用于那些需要在读取Excel文件时进行特定操作的场景，例如数据校验、处理等
 *
 * @param <T> 泛型参数，表示从Excel中读取的一行数据，可以是任何自定义对象
 */
public interface ExcelListener<T> extends ReadListener<T> {

    /**
     * 获取Excel读取结果
     * 该方法用于返回Excel监听器处理数据的结果，包括成功读取的数据列表和可能出现的错误信息
     * 实现类需要确保正确填充并返回这个结果对象，以便调用者可以获取读取操作的结果
     *
     * @return ExcelResult<T> 包含读取结果的对象，包括成功读取的数据和错误信息
     */
    ExcelResult<T> getExcelResult();

}
